home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Languages / Prograph Classic 2.6.1 / Examples / QuickTime for Classic / ProMovie.ReadMe < prev   
Text File  |  1995-09-28  |  5KB  |  82 lines

  1. Example:                                                ProMovie - A QuickTime Movie Editor
  2. Written by:                                        Garth Smedley, Pictorius Incorporated
  3. Updated for 2.6.1 by:            The Tech Support Team, Pictorius Incorporated
  4.  
  5. Note: QuickTime movies can take up a lot of memory - to use this example with certain movies it will probably be necessary to increase the memory partition of the Classic Interpreter.  Also keep this in mind when you compile your application.
  6.  
  7. Contents:         ProMovie.pgs
  8.                         ProMovie.ReadMe
  9.                         Array (XDef file)
  10.                         ProMovie About Box (Movie File)
  11.  
  12. Needs System Extensions:
  13.     QuickTime
  14.     ( Requires System 7 or later )
  15.  
  16. Needs Prograph Extensions:
  17.         The default configuration of your 'Prograph Extensions' folder, plus:
  18.         Array (included in this archive)
  19. The following five files should be moved back one level from the 'Prograph Extensions:Extra Toolbox' folder into the 'Prograph Extensions' folder (note that Prograph Classic WILL NOT find extension files in subfolders of the 'Prograph Extensions' folder):
  20.         ImageCompression
  21.         MediaHandlers
  22.         Movies
  23.         MoviesFormat
  24.         QuickTimeComponents
  25.  
  26. Needs Libraries to Compile:
  27.     SCLibrary 2.6
  28.     Library 2.6
  29.  
  30. Standard Classes That Were Modified:
  31.     Application/Notify                     - Processes movie events
  32.     Application/Update Menus        - Updates the File and Edit menus
  33.     Menu/Enable Item                      - A new method
  34.  
  35. New Classes:
  36.     Movie Window            - Displays a movie
  37.     Movie Options             - Movie options dialog
  38.  
  39. Description
  40. --------------
  41. ProMovie is a complete application which will open, play, edit and save QuickTime movies. ProMovie uses QuickTime's standard movie controller to do most of the work. 
  42.  
  43.  
  44. How To Use In Your Program
  45. -------------------------------------
  46. You will probably NOT want to use ProMovie as a starting point for your own application. Instead, borrow code for the functions you need. 
  47.  
  48. The File and Edit menu methods are all Universal Methods. Look at these to see how easy it is to open, save and perform simple editing operations on movies. The "Movie Options" class contains methods which change a movie's play options, such as looping. 
  49.  
  50. "Movie Window" has only a couple of methods, one for closing the window and disposing of the window's movie and another for adjusting the window's size. "Movie Window" has four new attributes; for the window's movie, movie controller, file id, and resource id. Look in the universal method "Open" to see how these are set. 
  51.  
  52. "Application/Notify" has a new first case. For every event, this case searches the window list for movie controllers and calls "MCIsPlayerEvent" for each. "MCIsPlayerEvent" is the magic routine which completely handles clicks in the movie controller and plays movies.  The call to "MoviesTask" speeds up the front movie when it's playing.
  53.  
  54. "Application/Update Menus" keeps the edit menu up to date; yet another thing that's easy with QuickTime.
  55.  
  56. When you open a movie, you will get a window which contains the movie and a controller. The controller is the QuickTime standard movie controller, it is pretty much self-explanatory, but here is an explanation anyway. 
  57.     • Turn sound on or off:
  58.             - Click on the speaker on the far left. 
  59.     • Play movie:
  60.             - Click on the little black triangle on the left. 
  61.     • Stop playing:
  62.             - The little black triangle on the left changes to a stop button when the movie is playing. 
  63.     • Play movie backwards:
  64.             - Shift-click on the little black triangle on the left. 
  65.     • Play movie by hand:    
  66.             - Drag the slider rectangle around. 
  67.     • Play movie one frame at a time:
  68.             - Click one of the two frame buttons on the right.
  69.     • Go to a particular place in the movie:
  70.             - Click on the slider bar.
  71.     • Go directly to the beginning or the end of the movie:
  72.             - Option-Click on one of the frame buttons on the right.
  73.     • Select a part of the movie:
  74.             - Shift-Click in the slider bar or Shift-Drag the slider.
  75.     • Select a single frame:
  76.             - Shift-Click in one of the frame buttons on the right. 
  77.  
  78. To edit a movie, select one or more frames as outlined above, and use the copy and paste functions.    ( There is a little bug in Paste, it adds to the selection instead of replacing it. Use  Clear before pasting to get the normal paste behavior. Sorry. )
  79.  
  80. To make the movie loop, select part or all of the movie, and choose the "Options" item in the "Edit" menu.  You will get a little dialog with a couple of buttons and check boxes. Check "Looping" and "Play Selection" then press OK.  ("Palindrome" make the movie play forward then backward)  ( Note that each movie has its own separate options settings)  Click on the play button. The movie will play just the selection in a continuous loop.  Press the play button again to stop the movie. (The play button changes to a pause button when the movie plays)
  81.  
  82.